home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / os2 / xdsn217.zip / DOC / debug.txt < prev    next >
Text File  |  1996-07-09  |  2KB  |  57 lines
  1. DEBUG.TXT                          Copyright (c) 1996 xTech Ltd
  2. ----------------------------------------------------------------
  3.  
  4.                  Native XDS-x86 OS/2 Edition
  5.                  ---------------------------
  6.                      v2.17 (pre-release)
  7.  
  8.                        Debugging notes
  9.  
  10.  
  11. 1. Using third-party debuggers
  12. ------------------------------
  13.  
  14. XDS produces machine code of high efficiency due to advanced code
  15. generation scheme but it makes very difficult to provide adequate
  16. debugging information. Now XDS compiler can output in an object file
  17. line numbers of the source file and information on program procedures
  18. and global variables. When appropriate options switched on, compiler
  19. generates object files with debugging information in well known
  20. CodeView format.
  21.  
  22. So you can use any debugger accepting this information. We have
  23. experience with Watcom's debugger WD and IBM's debugger IPMD.
  24. In the first case you have to link executable by Watcom's linker
  25. WLINK (don't fogget to include option "debug codeview") and
  26. then process EXE-file by CVPACK utility.
  27. In the second case you have to use LINK386 with option /CO.
  28.  
  29. Note that lacks in debugging information restricts some features
  30. of the debuggers.
  31.  
  32.  
  33. 2. Obtaining a call chain in the case of a program crash
  34. --------------------------------------------------------
  35.  
  36. XDS run-time support system includes special subroutine wich generates
  37. "errinfo.xds" file in the current directory on any abnormal program
  38. termination. This file includes name of EXE-file and a call chain at
  39. the moment of crash. The HIS utility (BIN\his.exe) decodes this
  40. information using program's map-file and outputs a list of procedure
  41. calls in the terms of source file names and line numbers.
  42.  
  43.  
  44. Related compiler option:
  45.  
  46. +LINENO      - to include source file line numbers in the object file
  47.  
  48. +GENDEBUG    - to include debuggin information on program procedures
  49.                and global variables
  50.  
  51. +GENHISTORY  - to include in MAIN module of a program call to RTS sub-
  52.                routine whitch generates "errinfo.xds" on any crash of
  53.                your program. This file contains a sequence of procedure
  54.                calls at the program abortation.
  55.  
  56.                           [end of document]
  57.